---
title: Utiliser Bun avec Astro
description: Apprenez à utiliser Bun avec votre site Astro.
type: recipe
i18nReady: true
---

[Bun](https://bun.sh/) est un moteur d'exécution et une boîte à outils JavaScript tout-en-un. Voir la [documentation de Bun](https://bun.sh/docs) pour plus d'informations.

:::caution
L'utilisation de Bun avec Astro peut révéler des imperfections. Certaines intégrations peuvent ne pas fonctionner comme prévu. Consultez [la documentation officielle de Bun pour travailler avec Astro](https://bun.sh/guides/ecosystem/astro) pour plus de détails.

Si vous rencontrez des problèmes lors de l'utilisation de Bun, veuillez [signaler un problème sur GitHub avec Bun directement](https://github.com/oven-sh/bun/issues/new/choose).
:::

## Prérequis

- Bun installé localement sur votre machine. Voir les [instructions d'installation](https://bun.sh/docs/installation) dans la documentation officielle de Bun.

## Créer un nouveau projet Astro avec Bun

Créez un nouveau projet Astro avec Bun en utilisant la commande `create-astro` suivante :

```bash
bun create astro mon-projet-astro-utilisant-bun
```

## Installer les dépendances

Si vous avez ignoré l’étape « Installer les dépendances ? » dans l’assistant CLI, assurez-vous d’installer vos dépendances avant de continuer.

```bash
bun install
```

## Ajouter des types

Bun publie le paquet [`@types/bun`](https://www.npmjs.com/package/@types/bun), contenant les types d'exécution pour Bun.

Installez `@types/bun` en utilisant la commande suivante :

```sh
bun add -d @types/bun
```

## Options d'installation de la CLI

### Utiliser des intégrations

Vous pouvez également utiliser l'une des intégrations officielles d'Astro avec la commande `astro add` :

```bash
bun astro add react
```

### Utiliser un thème ou un modèle de démarrage

Vous pouvez démarrer un nouveau projet Astro reposant sur un [exemple officiel](https://github.com/withastro/astro/tree/main/examples) ou la branche principale de n'importe quel dépôt GitHub en passant un argument `--template` à la commande `create astro`.

Exécutez la commande suivante dans votre terminal, en remplaçant le nom officiel du modèle de démarrage d'Astro ou le nom d'utilisateur GitHub et le dépôt du thème que vous souhaitez utiliser :

```bash
# créer un nouveau projet avec un exemple officiel
bun create astro@latest --template <nom-exemple>
# créer un nouveau projet reposant sur la branche principale d'un dépôt GitHub
bun create astro@latest --template <nom-utilisateur-github>/<depot-github>
```

## Développer et compiler

Pour exécuter le serveur de développement, utilisez la commande suivante :

```bash
bun run dev
```

### Compiler et prévisualiser votre site

Pour compiler votre site, utilisez la commande suivante :

```bash
bun run build
```

Une fois la compilation terminée, exécutez la commande d'aperçu appropriée (par exemple `bun run preview`) dans votre terminal et vous pourrez afficher la version compilée de votre site localement dans la même fenêtre d'aperçu du navigateur.

## Tests

Bun est fourni avec un exécuteur de tests rapide, intégré et compatible avec Jest via la [commande `bun test`](https://bun.sh/docs/cli/test). Vous pouvez également utiliser d’autres [outils de test pour Astro](/fr/guides/testing/).

## Ressources officielles

- [Construire une application avec Astro et Bun](https://bun.sh/guides/ecosystem/astro)

## Ressources communautaires

Vous utilisez Bun avec Astro ? Ajoutez votre article de blog ou votre vidéo à cette page !

- [Construire un site Cloudflare Pages avec Bun](https://blog.otterlord.dev/posts/hello-from-bun/) - article de blog
- [Utiliser Bun avec Astro et Cloudflare Pages](https://handerson.hashnode.dev/using-bun-with-astro-and-cloudflare-pages) - article de blog
